home *** CD-ROM | disk | FTP | other *** search
/ Cubase Magazine 5 / Issue #05.iso / 2-SOFTWARE / 2-SHAREWARE / WINAMP / PLUG-INS / VIS FUNKY / README.TXT next >
Text File  |  1998-07-27  |  6KB  |  177 lines
  1.                    Funky FX Plugin for WinAmp
  2.                              v0.01
  3.                    --------------------------
  4.  
  5.                           26 July 1998
  6.  
  7. Inroduction
  8. -----------
  9.  
  10. This archive contains the Funky FX FireWork plugin. This is version 0.01 -
  11. which means that it works, but I've not tested it extensively. And as it's
  12. taken me a grand total of 24 hours to write, you can be that there are "one
  13. or two" bugs hidden away somewhere.
  14.  
  15. The FireWork plugin displays some nice fireworks in time to whatever music 
  16. WinAmp is currently playing. Red fireworks represent the bass, green 
  17. fireworks represent the mid tones and blue fireworks represent the high 
  18. tones.
  19.  
  20. Parts of this plugin (i.e. the window managent code) are based on the 
  21. source code I obtained for the NolrS Speakers (vis_spk.dll) by Alex Black. 
  22. You can try looking at http://www.eng.uwaterloo.ca/students/speakers/ for 
  23. more information. Any bugs in this plugin are without doubt due to me
  24. however.
  25.  
  26. Disclaimer
  27. ----------
  28.  
  29. This software comes with no warranty - use it at your own risk (or as Sun
  30. Microsystems would say):
  31.  
  32. "THIS SOFTWARE IS NOT DESIGNED OR INTENDED FOR USE OR RESALE AS ON-LINE
  33. CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE
  34. PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES, AIRCRAFT
  35. NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE
  36. SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE SOFTWARE 
  37. COULD LEAD DIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE PHYSICAL OR 
  38. ENVIRONMENTAL DAMAGE ("HIGH RISK ACTIVITIES")."
  39.  
  40. So don't try and use it to control atomic toasters or anything.
  41.  
  42. Requirements
  43. ------------
  44.  
  45. This plugin should work with most hardware / software. Obviously it won't 
  46. look particularly exciting on a 486, but a mid to high end Pentium should 
  47. be fine. Having said that, I've only tested the plugin on a PII 266 and it 
  48. slows down loads when lots is going on. You can fiddle with the 
  49. configuration options below to speed it up (increase the culling rate, 
  50. decrease the # particles released etc).
  51.  
  52.  
  53. Installation
  54. ------------
  55.  
  56. Copy "vis_funkyfx.dll" to your WinAmp plugins directory (usually C:\Program 
  57. Files\WinAmp\Plugins\).
  58.  
  59.  
  60. Configuration
  61. -------------
  62.  
  63. There are various options that you can fiddle with to get the plugin 
  64. working more to your taste or just to speed it up:
  65.  
  66. Sensitivity - the sensitivty of the individual channels. Slide the sliders 
  67. to the right to make more fireworks appear.
  68.  
  69. Fire On Peak - doesn't actually seem to do much, but try it anyway - you 
  70. might like it.
  71.  
  72. Spectrum Analyzer - Turn on/off a cheesy looking spectrum analyzer. Best 
  73. turned off.
  74.  
  75. Particle Size - Turn this down to speed things up slightly.
  76.  
  77. Particles Per Explosion - Set how many particles are emitted in each 
  78. explosion. This ranges from about 10 to 200. Turn this down if things slow
  79. down a bit.
  80.  
  81. Particle Cull Rate - Determines how quickly particles disappear from the 
  82. screen. Increase this to speed things up a bit.
  83.  
  84. Only Fire Up - When used with gravity, this makes things look nicer. Just
  85. trust me.
  86.  
  87. Gravity - Enable or disable gravity.
  88.  
  89. Jitter - Turn this on to make the particles wibble about as they fly off. 
  90. This gives a more natural looking explosion effect. Really.
  91.  
  92.  
  93. Known Bugs
  94. ----------
  95.  
  96. The plugin doesn't want to work in double size mode. Not only does it not 
  97. display correctly, but it's cripplingly slow. Should be fixed in the next 
  98. release.
  99.  
  100. I've no idea if it frees all the memory that it allocates. It allocates 
  101. memory every time it creates a particle. It may or may not always free this 
  102. memory :-)
  103.  
  104. Please report any obvious bugs to paulh@javigate.com
  105.  
  106.  
  107. Future Plans
  108. ------------
  109.  
  110. I've got a few ideas on how to improve the plugin. You probably have to - 
  111. let me know at paulh@javigate.com. Ta.
  112.  
  113. FireWorks
  114. ~~~~~~~~~
  115.  
  116. Make double size mode work, and add a full screen (DirectDraw) option.
  117.  
  118. Allow further configuration of the particle sources - i.e. colour; number; 
  119. range of frequencies over which they are sensitive; individual controls for 
  120. # particles, culling rate etc.
  121.  
  122. Improve the spectrum analyzer or remove it completely (it's only in there 
  123. so that I can test the frequency response etc). Might replace it with a 
  124. nice bezier curve or something.
  125.  
  126. Make it faster.
  127.  
  128. Funky FX
  129. ~~~~~~~~
  130.  
  131. I'm considering porting some of the demo code I've written to work as a 
  132. plugin. Watch out for lens, fire, water and atomic blob things. And bump 
  133. mapping too.
  134. May do some kind of sound processing module too...
  135.  
  136.  
  137. Source Code
  138. -----------
  139.  
  140. I will get around to releasing the source code for anyone who fancies 
  141. nosing around, but I want to clean it up first - it's the software 
  142. equivalent of my bedroom at the moment (safe, but you wouldn't want your 
  143. mum to see it).
  144.  
  145. Version History
  146. ---------------
  147.  
  148. 26 Jul 1998 - v0.01 - Initial Release
  149.  
  150. Credits Etc
  151. -----------
  152.  
  153. Based on original source code by Alex Black - adblack@novice.uwaterloo.ca
  154.  
  155. Everything else written and Copyright by Paul Holden (paulh@javigate.com).
  156.  
  157. WinAmp (http://www.winamp.com/) is produced by Nullsoft 
  158. (http://www.nullsoft.com/). It's probably copyrighted, trademarked and so 
  159. on by them too.
  160.  
  161. Hellos to Stevey-Boy, Chris and Fiwl.
  162.  
  163. Contact
  164. -------
  165.  
  166. The homepage for this plugin is at http://www.javigate.com/FunkyFX/
  167. There's some other fun stuff at Javigate.com too - try out 
  168. http://www.javigate.com/TVAP/
  169.  
  170. I can be contacted at paulh@javigate.com, or if that fails,
  171. paulh@irsoft.demon.co.uk. My rather mediocre home page is at
  172. http://www.javigate.com/paulh/
  173.  
  174.  
  175. Paul Holden
  176. York, UK
  177. 26 July 1998